home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / misc / muroloutil / switch.doc < prev    next >
Text File  |  1993-11-02  |  3KB  |  114 lines
  1.                                   SWITCH
  2.                                =============
  3.  
  4.               (C) 1993 by Felice Murolo, all rights reserved
  5.  
  6.                             Switch is FREEWARE.
  7.  
  8.  
  9. 0. About
  10. ========
  11. This program is FREEWARE, you may copy and spread it, as you want, but
  12. you MUST NOT earn money with it.
  13. If you give this program to someone else, you have to copy the whole
  14. package which must consist of:
  15.  
  16.  - this document
  17.  - a working copy of SWITCH
  18.  
  19.      THE AUTHOR  UNDERTAKES  NO  LIABILITY FOR  ANY  DAMAGE CAUSED  BY  THE
  20.      APPROPRIATE OR NOT APPROPRIATE USE OF THIS PROGRAM !
  21.  
  22.      THE AUTHOR  UNDERTAKES  NO LIABILITY  FOR  THE FAULTLESSNESS  OF  THIS
  23.      PROGRAM !
  24.  
  25.      USE IT AT YOUR OWN RISK !
  26.  
  27. If you have hints, bug-reports, criticism, *MONEY*, postal cards, flowers or
  28. PD-soft for me, write to:
  29.  
  30.                                Felice Murolo
  31.                              Via Posidonia 205
  32.                            84128 Salerno, Italia
  33.  
  34.            Network: 2:335/206@fidonet.org 39:102/5@amiganet.ftn
  35.                   BBS +39 (0)89 756281 21:00 to 08:00 HST
  36.  
  37. If you want an answer, please add postage !
  38.  
  39.  
  40. 1. Sources
  41. ==========
  42. Package don't include sources. Sources are available from the author. To
  43. have sources:
  44. - FidoNet-AmigaNet people: send 5 US$(7000 Italian lires) and your
  45.   network address. I'll crash you the sources;
  46. - Other people: send 10$ and your postal address and i'll send you a disk
  47.   with sources of this and some other utilities;
  48.  
  49.  
  50. 2. IMPORTANT
  51. ============
  52. All the donations (for sources or simply for present) will be devolved to
  53. A.I.R.C. (Italian Association for Cancer Research).
  54.  
  55.  
  56. 3. Hardware
  57. ===========
  58. Switch runs ONLY under Kickstart 2.0 or greater. It needs 512kB, the stack
  59. should be about 4000 bytes. In LIBS: must be gadtools.library.
  60.  
  61.  
  62. 4. How it Works
  63. ===============
  64. Switch works only from CLI.
  65. Switch is a program which opens a little center window on a pubblic
  66. screen (default WorkBench screen, customizable with PUBSCREEN switch).
  67. The window have 3 gadgets into it:
  68.  
  69. - a text gadget, which stores the text you have passed via CLI with
  70.   ACTION_TEXT switch;
  71. - two buttons, one for CONTINUE and other for EXIT function.
  72.  
  73. If you click on CONTINUE, program exits and returns 0. If you click on EXIT,
  74. program exits and returns 5. Keys "C" and "E" are the underscore values for
  75. CONTINUE and EXIT.
  76. If you do nothing, the program exits after a programmable time (default 3
  77. seconds, to change use DELAY switch).
  78.  
  79.  
  80. 5. Usage of Switch
  81. ==================
  82. The uses of switch can be a lot. I use it in some batch files, to popup a
  83. little requester. General use of switch is:
  84.  
  85. ;This is a batch file
  86.  
  87. failat 10
  88. echo "*NSwitch test!*N"
  89.  
  90. ;popup a requester on TrapDoor public screen, and set a delay time of
  91. ;5 secs
  92. switch ACTION_TEXT="I'm executing TEST2" DELAY=5 PUBSCREEN="TrapDoor"
  93.  
  94. if warn
  95.    echo "Exiting and execute TEST1"
  96.    skip TEST1
  97. endif
  98.  
  99. lab TEST1
  100. echo "This is Label 1"
  101. quit
  102.  
  103. lab TEST2
  104. echo "This is Label 2"
  105.  
  106.  
  107. ;End of batch file
  108.  
  109.  
  110.  
  111. Enjoy!
  112. -Felice Murolo
  113.  
  114.